home *** CD-ROM | disk | FTP | other *** search
/ PC Gamer (Italian) 24 / PC Gamer IT CD 24 2-2.iso / DESK95 / mpl101 / mpl.txt < prev   
Text File  |  1997-07-06  |  13KB  |  394 lines
  1.  
  2.  
  3.               Multi Program Launcher for Windows 95 and Windows NT Version 1.01
  4.               ─────────────────────────────────────────────────────────────────
  5.  
  6.  
  7.                      Copyright (c) 1997 Chris Wood,  All Rights Reserved
  8.                      ───────────────────────────────────────────────────
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.    Disclaimer
  17.    ──────────
  18.  
  19.    This program is copyrighted material for personal use on one computer, if any business
  20.   or organization's wish to use a customized or standard version of MPL as a launch pad
  21.   for their systems, then please contact me at 'chris.wood@programmer.net' to discuss
  22.   this further.
  23.  
  24.    If you would like to continue to use version 1.01 of MPL after an evaluation period of
  25.   ten days, you will need to register MPL just by sending ten uk pounds (Sterling) to the
  26.   address at the end of this document, with your name, email address, full postal address,
  27.   and any suggestions or opinions you may have to improve MPL.
  28.  
  29.    If you come across any bugs, or you wish to make any suggestions to improve MPL, just
  30.   drop me a line at 'chris.wood@programmer.net'.
  31.  
  32.    This program can only be used on the understanding that no responsibility is held by or
  33.   can be accepted by the author for any problems arising through its use, or misuse.
  34.  
  35.     It is the understanding of the author that this program operates in the manner in which
  36.   it is intended and contains no major 'bugs' or errors.
  37.  
  38.    No charge, other than a nominal disk handling, duplication and postage fee, may be made
  39.   for it and should be supplied as an archived file bearing the file name 'MPLvvv.???',
  40.   where 'vvv' corresponds to the version number (ie 100) and '???' corresponds to a relevant
  41.   archive extension (such as ZIP, ARJ, RAR, etc) which contains the files listed below.
  42.  
  43.  
  44.    Archive File contents
  45.    ─────────────────────
  46.  
  47.    FILE_ID  DIZ........Brief Description.
  48.    MPL      TXT........This file.
  49.    MPL      EXE........Multi Patch Compiler executable file.
  50.    MPL      INI........Initialization file for MPL.
  51.  
  52.    All information provided by this text file is for guidance only.
  53.  
  54.  
  55.  
  56.    Description
  57.    ───────────
  58.  
  59.    MPL is a small (36kb), easy to use, but very powerful Win95/NT notify bar program
  60.   launcher (icon stored next to the clock on bottom right hand corner of the screen),
  61.  
  62.    It is fully configurable, because at present the maximum viewable number of vertical popup
  63.   menu entries is thirty seven at 800x600 resolution, and forty six at 1024 x 768 resolution,
  64.   I have included an option to create up to 65535 user configurable submenus, to get around
  65.   this paltry restriction.
  66.  
  67.    MPL can open any file which has a file association, and is able to run normal executable
  68.   files, you can associate several different executable files to one menu entry to make life
  69.   easier.
  70.  
  71.    I have also included an option to start the executable files in various display modes, i.e.
  72.   hidden, minimized, maximized, etc, as well as being able to select default directories to run 
  73.   from.
  74.  
  75.  
  76.  
  77.    Installation
  78.    ────────────
  79.  
  80.    Extract 'MPL101.ZIP' file into one directory, and start 'MPL.EXE', place the mouse cursor
  81.   over the world icon, and press the right mouse key to display the popup menu. I strongly
  82.   recommend you to select 'Edit', and edit the 'MPL.INI' file to reflect your system settings.
  83.  
  84.    After that you can start experimenting, by adding additional menu entries, submenus, etc.
  85.  
  86.    I recommend you make a shortcut for MPL, in your startup program group, then MPL is always
  87.   loaded automatically, and ready for use.
  88.  
  89.  
  90.  
  91.    Multi Program Launcher Usage
  92.    ────────────────────────────
  93.  
  94.  
  95.       Syntax :- MPL.EXE
  96.  
  97.       To display the popup menu, place mouse cursor over world icon, press right mouse button,
  98.      and to access the 'MPL.INI' file for editing quickly, place mouse cursor over world icon,
  99.      press left mouse button, it is as simple as that.
  100.  
  101.  
  102.  
  103.    Multi Program Launcher INI File Options
  104.    ───────────────────────────────────────
  105.  
  106.  
  107.    Note all spaces, indicated between '=' sign and program name, and or menu name, are
  108.   essential, for the correct handling of the function commands.
  109.  
  110.    If you wish to add comments in the 'MPL.INI' file, then just put an ';' (semi-colon) as
  111.   the first character on the line in front of the comment to render the rest of the line
  112.   invisible to MPL.
  113.  
  114.  
  115.  
  116.    [Application Title] - Displayed menu, and submenu entries
  117.    ─────────────────────────────────────────────────────────
  118.  
  119.    At present the maximum viewable number of vertical popup menu entries is thirty seven at
  120.   800x600 resolution, and forty six at 1024 x 768 resolution.
  121.  
  122.    On top of this you have the option of having up to 65535 popup menus, which again extends
  123.   MPL further still.
  124.  
  125.  
  126.  
  127.    Menu Entries
  128.    ────────────
  129.  
  130.    If you wish to create a menu entry, this can be done in two forms, depending on where you
  131.   wish to have the menu entry displayed,
  132.  
  133.    Syntax:-
  134.  
  135.         Create a Menu Entry directly after a create submenu command.
  136.  
  137.           3=Send Email to Chris
  138.           | |^^^^^^^^^^^^^^^^^^
  139.           | Text to be displayed.
  140.           |
  141.           Menu Entry index, for running Command Line Applications.
  142.  
  143.  
  144.  
  145.         Create a Menu Entry in a specific submenu.
  146.  
  147.           4=-0 Explorer
  148.           | || |^^^^^^^
  149.           | || Text to be displayed.
  150.           | ||
  151.           | |Submenu index.
  152.           | |
  153.           | Switch to indicate select submenu.
  154.           |
  155.           Menu Entry index, for running Command Line Applications.
  156.           
  157.         
  158.         NOTE:- The first menu entry must be done in the latter format of the above, to 
  159.               correctly setup the menu entries in the base popup menu, otherwise you
  160.               will get an extra character after the initial menu entry.
  161.  
  162.  
  163.  
  164.    Submenu Entries
  165.    ───────────────
  166.  
  167.    MPL has the ability to handle up to 65535 popup submenus, and to add a submenu, just
  168.   include a line similar to (9999=-S0 1 Submenu1), this will create 'submenu1' directly
  169.   linked to the base popup menu, and all (4=-1 Explorer) menu entries will be placed in this
  170.   submenu.
  171.  
  172.    Syntax:-
  173.  
  174.         Create a submenu,
  175.  
  176.           9999=-S0 1 Internet
  177.           |    |^| | |^^^^^^^
  178.           |    | | | Text to be displayed.
  179.           |    | | |
  180.           |    | | New Submenu index.
  181.           |    | |
  182.           |    | Link to Submenu 0
  183.           |    |
  184.           |    Switch to indicate create new submenu.
  185.           |
  186.           Menu Entry index, this should be a Command Line Index which is not going to be used.
  187.  
  188.  
  189.  
  190.    Command Line Entries
  191.    ────────────────────
  192.  
  193.    The Command Line entries are indexed, to directly link them to the corresponding Menu
  194.   Entries, you can execute files using file association, or directly just using the correct
  195.   executable filename.
  196.  
  197.    Also you can use window handling switches, which allows you to hide, minimize, maximize
  198.   restore, and just show windows normally.
  199.  
  200.    Syntax:-
  201.  
  202.         Window switches
  203.  
  204.           -H......Hide window, the only programs that are not hidden are programs that access the notify bar.
  205.           -X......Maximize window.
  206.           -M......Minimize window.
  207.           -N......Normal window.
  208.           -R......Restore window (default).
  209.  
  210.  
  211.         Default directory switch
  212.  
  213.           -D [drive:directory]
  214.  
  215.           Runs the program in a specific directory, this switch can be combined with the above window switches.
  216.  
  217.           -HD [drive:directory] [executable filename]
  218.  
  219.           Hides the window, and runs filename in drive:directory.
  220.  
  221.  
  222.         Using file association,
  223.  
  224.           0=mpl.ini
  225.           | |^^^^^^
  226.           | Execute file association with '*.ini' files.
  227.           |
  228.           Command Line Index, this should be directly linked to a Menu Entry.
  229.  
  230.  
  231.           2=-M http://homepages.enterprise.net/cwood/
  232.           | |^ |^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  233.           | |  Execute file association with 'http:' files, default web browser.
  234.           | |
  235.           | Minimize window on startup.
  236.           |
  237.           Command Line Index, this should be directly linked to a Menu Entry.
  238.  
  239.  
  240.  
  241.         Directly run executable programs.
  242.  
  243.           1=-X C:\WIN\EXPLORER.EXE ::{20D04FE0-3AEA-1069-A2D8-08002B30309D}\::{992CFFA0-F557-101A-88EC-00DD010CCC48}
  244.           | |^ |^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  245.           | |  Execute file with parameters.
  246.           | |
  247.           | Maximize window on startup.
  248.           |
  249.           Command Line Index, this should be directly linked to a Menu Entry.
  250.  
  251.  
  252.           1=-HD c:\internet\magic\ c:\internet\magic\magic.exe
  253.           | |^| |^^^^^^^^^^^^^^^^^ |^^^^^^^^^^^^^^^^^^^^^^^^^^
  254.           | | | |                  Execute file with no parameters.
  255.           | | | |
  256.           | | | Default directory.
  257.           | | |
  258.           | | Default diretory switch.
  259.           | |
  260.           | Hide window on startup.
  261.           |
  262.           Command Line Index, this should be directly linked to a Menu Entry.
  263.  
  264.  
  265.           Note:- The double quotes surrounding the LFN.
  266.  
  267.           1="c:\misc\Untouchable Pro 2.0\untouch.exe"
  268.           | |^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  269.           | Execute LFN files.
  270.           |
  271.           Command Line Index, this should be directly linked to a Menu Entry.
  272.  
  273.  
  274.  
  275.    Example 'MPL.INI'
  276.    ─────────────────
  277.  
  278.    ;
  279.    ; This is a comment line
  280.    ;
  281.    [Application Title]
  282.    0=-0 Edit
  283.    1=Internet Tools
  284.    9999=-
  285.    9999=-S0 1 Internet
  286.    2=Chris WWW page
  287.    3=Send Email to Chris
  288.    4=-0 Explorer
  289.  
  290.    [Command Line]
  291.    0=mpl.ini
  292.    1=-H c:\internet\magic\magic.exe
  293.    1="c:\misc\Untouchable Pro 2.0\untouch.exe"
  294.    1=-X C:\WIN\EXPLORER.EXE ::{20D04FE0-3AEA-1069-A2D8-08002B30309D}\::{992CFFA0-F557-101A-88EC-00DD010CCC48}
  295.    2=http://homepages.enterprise.net/cwood/
  296.    3=mailto:chris.wood@programmer.net?subject=MPL Public Suggestions
  297.    4=-M C:\WIN\EXPLORER.EXE /n,/e,c:\
  298.  
  299.  
  300.  
  301.    Shareware Note
  302.    ──────────────
  303.  
  304.    Important note, the shareware version has been restricted to five menu entries, and
  305.   one sub menu entry, if you wish for more then just register MPL, and you will receive
  306.   your key to unlock your version of MPL.
  307.  
  308.    If you are wondering how I came to this number, it is because I personally do not use
  309.   more than three menu entries, and I do not use submenus, and this does all what I want
  310.   it to do.
  311.  
  312.  
  313.  
  314.    Registration
  315.    ────────────
  316.  
  317.    To register your use of 'Multi Program Launcher' version 1.01, just send ten uk pounds
  318.   (Sterling) to,
  319.  
  320.                                  Mr C.Wood
  321.                                  73 Bouverie Road West
  322.                                  Folkestone
  323.                                  Kent
  324.                                  CT20 2RL
  325.                                  United Kingdom
  326.  
  327.  
  328.    Supplying me with your Name, Email address, and Postal address, any suggestions, or
  329.   comments, or opinions to improve MPL, with the monies in any of the forms listed below,
  330.   and in return I will issue you with your own key to unlock the full power of MPL.
  331.  
  332.    Payment can be made in Cash, or Postal Order, or Cheque drawn on a UK bank account,
  333.   or Travellers Cheque.
  334.  
  335.    Bulk discounts and site licenses can be arranged, send email to email address below
  336.   to discuss further.
  337.  
  338.    Indicate whether you prefer to receive your key via email (attached, or text only),
  339.   or by snail mail, keys are released on clearance of funds.
  340.  
  341.  
  342.  
  343.    Help, suggestions, and or bug reporting
  344.    ───────────────────────────────────────
  345.  
  346.    If you need any help with 'Multi Program Launcher', or have any suggestions for future
  347.   releases of 'Multi Program Launcher', or you find any bugs which might have slipped
  348.   through the net, then please contact me via email at the address below,
  349.  
  350.  
  351.                      Internet:-  chris.wood@programmer.net
  352.  
  353.  
  354.  
  355.    Future
  356.    ──────
  357.  
  358.    Awaiting useful suggestions, as MPL does exactly what I wanted it to do and more, so
  359.   the only way to improve it, is via good end user suggestions.
  360.  
  361.  
  362.  
  363.    History
  364.    ───────
  365.  
  366.    I originally developed the basic version of 'Multi Program Launcher' in Delphi 2.00
  367.   RAD system, and I was quite dismayed to see a 219kb file to do something so basic, and
  368.   simple.
  369.  
  370.    So I sat down and wrote a much tighter version by hand (36kb), this is not
  371.   quite as pretty as the original version but then again this is smaller, tighter,
  372.   faster, and has submenus to boot, among other things.
  373.  
  374.    And if you are interested, this is my first attempt at writing a 32bit Windows
  375.   program, so do not moan if it is not what you are looking for, just do not use it,
  376.   or better still email me your suggestions to make it better, but feel free to pass the
  377.   original 'MPL101.ZIP' file around to your friends.
  378.  
  379.    'Multi Program Launcher'
  380.  
  381.           Version 1.01 - Corrected my over zealous re-use of variables, which caused
  382.                         a serious flaw in the submenu handling routine.
  383.  
  384.                          Added default directory switch.
  385.  
  386.  
  387.           Version 1.00 - First beta release.
  388.  
  389.  
  390.                                      End
  391.  
  392.  
  393.  
  394.